home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / decode10.zip / DECODE.DOC < prev    next >
Text File  |  1992-12-07  |  50KB  |  1,669 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                    Decode It!(TM)
  10.  
  11.  
  12.  
  13.                    The Binary Data Fourth Generation Language(TM)
  14.  
  15.  
  16.  
  17.                                     Version 1.0
  18.  
  19.  
  20.                                    Users' Manual
  21.  
  22.  
  23.  
  24.  
  25.                                     Created by
  26.  
  27.  
  28.                                     Bob Preston
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                                  Axiom Innovations
  45.  
  46.                                54 Settlers Farm Road
  47.  
  48.                              Monroe, Connecticut 06468
  49.  
  50.  
  51.      Copyright 1992 Axiom Innovations.  All Rights Reserved.
  52.      Printed in the United States of America.
  53.  
  54.  
  55.      Decode It!(TM) and Decode It! 4GL(TM) are trademarks of Axiom
  56.      Innovations.  All trademarks and registered trademarks referenced within
  57.      this document are the property of their respective owners.
  58.  
  59.  
  60.  
  61.  
  62.                                  LICENSE AGREEMENT
  63.  
  64.  
  65.  
  66.      USE OF THIS PRODUCT BINDS YOU TO THE TERMS OF THIS LICENSE AGREEMENT.
  67.      PLEASE READ THE AGREEMENT CAREFULLY AND DO NOT USE THIS PRODUCT IF YOU DO
  68.      NOT AGREE TO THE TERMS OF THE AGREEMENT.
  69.  
  70.  
  71.  
  72.      1. LICENSE.  You may use this product for an evaluation period of 30
  73.      days.  After the evaluation period you are required to purchase a
  74.      registered copy.  Axiom Innovations grants permission for this shareware
  75.      product to be copied and distributed, if no fees are charged.  Otherwise,
  76.      you must get written permission from Axiom Innovations to distribute
  77.      copies of this product.  Said permission is granted only for the
  78.      distribution of unaltered and intact copies of this product.
  79.  
  80.  
  81.      2. COPYRIGHT.  This product is licensed to you, for your own use.  This
  82.      is copyrighted software.  You are not obtaining title to the product or
  83.      any copyright rights.  You may not sublicense, rent, lease, convey,
  84.      modify, translate, decompile, or disassemble this product, in whole or in
  85.      part, except as expressly provided for in this license.
  86.  
  87.  
  88.      3. COPIES.  You may make as many copies of this product as you need for
  89.      back-up purposes.  You may use this product on more than one computer,
  90.      provided there is no chance it will be used simultaneously on more than
  91.      one computer.  If you need to use the software on more than one computer
  92.      simultaneously, please contact us for information about site licenses.
  93.  
  94.  
  95.      4. LIMITED WARRANTY.  THIS PRODUCT IS LICENSED "AS IS" WITHOUT ANY
  96.      WARRANTY OF ANY KIND, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES
  97.      OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ALL OF WHICH ARE
  98.      EXPRESSLY AND SPECIFICALLY DISCLAIMED.  Some states do not allow the
  99.      exclusion of implied warranties, so the above limitation may not apply to
  100.      you.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.        Decode It! Version 1.0                                         Page 1
  109.  
  110.  
  111.      5. LIMITATION OF LIABILITY.  IN NO EVENT SHALL AXIOM INNOVATIONS OR
  112.      ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR
  113.      DELIVERY OF THIS PRODUCT BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR
  114.      INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THIS
  115.      PRODUCT EVEN IF AXIOM INNOVATIONS HAS BEEN ADVISED OF SUCH DAMAGES OR
  116.      CLAIMS.  IN NO EVENT SHALL AXIOM INNOVATIONS LIABILITY FOR ANY DAMAGES
  117.      EVER EXCEED THE PRICE PAID FOR THE LICENSE TO USE THIS PRODUCT,
  118.      REGARDLESS OF THE FORM OF CLAIM.  Some states do not allow the exclusion
  119.      of the limit of liability for consequential or incidental damages, so the
  120.      above limitation may not apply to you.
  121.  
  122.  
  123.      6. GOVERNING LAW.  This agreement shall be governed by the laws of the
  124.      State of Connecticut and shall inure to the benefit of Axiom Innovations
  125.      and any successors, administrators, heirs and assigns.  Any action or
  126.      proceeding brought by either party against the other arising out of or
  127.      related to this agreement shall be brought only in a STATE or FEDERAL
  128.      COURT of competent jurisdiction located in Fairfield County, Connecticut.
  129.      The parties hereby consent to in personam jurisdiction of said courts.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.        Decode It! Version 1.0                                         Page 2
  169.  
  170.  
  171.  
  172.                                  TABLE OF CONTENTS
  173.  
  174.  
  175.  
  176.  
  177.              1.0  What is Decode It!?  .............................    4
  178.              2.0  The Shareware Concept  ...........................    5
  179.              3.0  System Requirements  .............................    5
  180.              4.0  Installation  ....................................    6
  181.              5.0  Lets Try It Out!  ................................    6
  182.              6.0  Basic Features  ..................................   10
  183.              6.1  Rules  ...........................................   10
  184.              6.2  RECORDs  .........................................   11
  185.              6.3  END Command  .....................................   12
  186.              6.4  Criteria  ........................................   12
  187.              6.5  Undefined Values  ................................   13
  188.              6.6  Guidelines  ......................................   14
  189.              7.0  Advanced Features  ...............................   15
  190.              7.1  Blocks  ..........................................   15
  191.              7.2  Control Flow Commands  ...........................   15
  192.              7.3  4GL Processor Commands  ..........................   16
  193.              7.3.1  (ORDER) Command  ...............................   16
  194.              7.3.2  (OMIT) Command   ...............................   16
  195.              7.4  System Variable (.OFFSET)  .......................   17
  196.              8.0  Examples  ........................................   17
  197.              8.1  EXEINFO.RUL Revisited  ...........................   17
  198.              8.2  C Unions  ........................................   17
  199.              8.3  IF ... THEN ... ELSE  ............................   19
  200.              8.4  IF ... AND/OR  ...................................   19
  201.              9.0  Parameters  ......................................   20
  202.              10.0  4GL Quick Reference  ............................   21
  203.              10.1  Rules Format  ...................................   21
  204.              10.2  Records and Blocks Formats  .....................   21
  205.              10.3  Criteria Format  ................................   22
  206.              10.4  Control Flow Commands  ..........................   22
  207.              11.0  Registration  ...................................   23
  208.              Appendix A:  Error Messages  ..........................   24
  209.              A.1  Main Program Errors  .............................   24
  210.              A.2  4GL Processor Errors  ............................   24
  211.              A.3  File Interpreter Errors  .........................   26
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.        Decode It! Version 1.0                                         Page 3
  229.  
  230.  
  231.      1.0  What is Decode It!?
  232.  
  233.      Decode It! is a simple, yet powerful fourth generation language (4GL)
  234.      tailored for binary data interpretation.  It excels in interpreting
  235.      binary files containing fixed or variable length records and multiple
  236.      record layouts.
  237.  
  238.      By applying your data format rules to raw binary data, Decode It! exposes
  239.      the underlying structure of binary information and transforms it into
  240.      readable ASCII text.  This text can be redirected to a file, or piped to
  241.      MORE and LIST.  You specify the format, so data is displayed the way you
  242.      want to see it.
  243.  
  244.      In addition, Decode It! opens up binary data to the world of text
  245.      manipulation tools.  Once created, Decode It! files can be used with
  246.      DIFF, AWK, GREP, Norton's TS, and any other text utility.
  247.  
  248.      Some of Decode It!'s features are:
  249.  
  250.           Easy installation on single user and local area network systems
  251.           (not copy protected).
  252.  
  253.           Easy to use Fourth